Troubleshooting

Most issues come down to credentials, indexing, or licensing state. This page collects the common ones and how the app keeps itself up to date.

Credentials & connection

A red credential pill with a Sign in / Enter MFA action. Your AWS token expired and needs re-auth. Click the inline Sign in (SSO or an aws login session) or Enter MFA (TOTP role) action on the credential pill at the top of the sidebar, or just re-run the query — DynoTable re-authenticates on demand. An amber/orange dot is different: the token is expiring soon but will refresh automatically, so there's nothing to do. See Connect an AWS account.

SSO login does nothing / the browser doesn't open. DynoTable runs the OAuth device flow in-process. If the browser tab doesn't appear, check that your ~/.aws/config SSO profile is valid by running aws sso login once from a terminal. DynoTable writes to the same ~/.aws/sso/cache, so a working CLI login confirms the profile.

AWS CLI not found when signing in an aws login profile. A profile signed in with aws login is renewed by running the AWS CLI itself (aws login --profile <name>), so Sign in fails if DynoTable can't find the CLI. An app opened from the Finder doesn't inherit your shell's PATH, so DynoTable looks in /opt/homebrew/bin, /usr/local/bin, /usr/local/aws-cli and /usr/bin first. Install the AWS CLI in one of those places, or run aws login --profile <name> in a terminal yourself and re-run the query.

A table I expect isn't listed. DynoTable lists every table in the active profile and region. If one is missing, you're either in the wrong region (switch it per tab) or a Table Prefix Filter on the profile is hiding tables that don't start with the prefix. Clear or adjust it in the profile's connection settings. ⌘K draws from the same filtered list, so a prefix or region mismatch hides the table there too.

Data & queries

Results look stale or empty. Re-run the query with ⌘R.

Smart Tables and Workbench query DynamoDB live. If expected fields or values are missing from suggestions, check the table's indexing status and limits.

A filter returns nothing I expect. Check you're in the right query mode (⌘⇧M toggles Visual / PartiQL) and that the key filter targets the correct attribute. See Filters & query patterns.

Writes are blocked

If saving an item, committing a staged change, or running a PartiQL write all fail, the app is in : your license lapsed. Reads and exports still work. Click Reconnect in the banner; if your subscription is valid you're back to Active immediately. See Activation.

AI isn't working

The chat shows a Configure AI banner instead of a composer until you pick a Bedrock-capable AWS profile and region in the profile's AI section and click Test Connection. You also need Bedrock model access enabled in that account and region. Full setup: AI chat.

Updates

How DynoTable gets new versions depends on your platform.

PlatformHow it updates
macOSIn-app auto-update. Checks on launch and periodically; downloads in the background.
WindowsIn-app auto-update, same as macOS.
Linux.deb / .rpm update through your package manager; the AppImage is a manual download.

On macOS and Windows, when a new build has downloaded an "Update ready — restart" banner appears. Restart to apply it. Occasionally a release sets a minimum supported version; if your build is below it, the banner becomes a blocking "Update required" until you restart into the new version.

Still stuck?

DynoTable with an active profile. Check the credential pill at the top of the sidebar before debugging empty tables or failed queries.
DynoTable with an active profile. Check the credential pill at the top of the sidebar before debugging empty tables or failed queries.
  • Activation and Devices: licensing and the two-machine limit.
  • Settings: where every preference lives.
  • Account billing: your plan, invoices, and subscription.
  • Common DynamoDB API faults (ValidationException, throttling, IAM denials, expression syntax) are covered in the DynamoDB guides: match the exception name, then fix IAM, keys, or expression syntax.
  • Size expensive Scans before you re-run them with the pricing calculator.

Updated