Skip to content

Runestone Documentation Issue: Migration troubleshooting in 6.5 #1268

Description

@magnus-mccaslin

Page found:

https://docs.runestone.academy/en/latest/running.html

Description

While working through the installation process, I encountered a migration issue during updating in 6.5 that was resolved by manually stamping the database to the latest Alembic revision. These troubleshooting steps are not currently included in the official documentation, but could help users who continue to experience migration errors after following the standard setup process.

I suggest adding the following note to the installation or troubleshooting section of 6.5:

If you are still experiencing migration errors, try the following commands:

docker compose run --rm rsmanage alembic stamp head
docker compose run --rm rsmanage alembic current

The second command should display the current revision with (head) next to it. If it does, the migration issue has been successfully resolved.

Including these commands would provide users with a straightforward way to recover from migration state mismatches without having to search through issue discussions or ask for support.

GitHub: magnus-mccaslin

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions