Skip to content

Update instructions #2400

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
manumoreira wants to merge 3 commits into from
Closed

Update instructions #2400

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ca7629f
Fix #2397. Add vertical scroll on ImportSampleModal
manumoreira Jan 16, 2026
7d0dcf5
Merge branch 'main' of https://github.com/instedd/surveda
manumoreira Mar 5, 2026
74eafe7
update-instructions
manumoreira Mar 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ You can setup your local environment following different approaches.
If you don't need to connect to Verboice nor Nuntium, you can move forward with this setup.

1. You need to use [dockerdev](https://github.com/waj/dockerdev) to access the web app at `app.surveda.lvh.me` and ngrok at `ngrok.surveda.lvh.me`. Just follow the project's readme. **WARNING:** You should install `dockerdev` _before_ creating your stack's network in Docker. If you have already run `./dev-setup.sh`, you may want to run `docker compose down -v` to **delete every container, data and other artifacts** from the project and start from scratch _after_ running `dockerdev`.
Make sure you use the right `dockerdev` image `docker pull --platform linux/arm64 manastech/dockerdev`
2. Clone this repository.
3. In the project's root, execute `./dev-setup.sh`.
4. Start the app with `docker compose up`.
Expand Down
6 changes: 3 additions & 3 deletions docs/dev-setup-cloud.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,14 @@ This guide describes the steps needed to have a development environment that wil
* Nuntium for sending and receiving https://nuntium-stg.instedd.org

1. Install [dockerdev](https://github.com/waj/dockerdev)
2. Checkout the project
2. Checkout the project. Suggested `dockerdev` image `linux/arm64 manastech/dockerdev`
3. Execute `$ ./dev-setup.sh`
4. `$ docker compose up ngrok`
* NOTE: if `ngrok` container is restarted the assigned tunnel URL will change and it will need to be updated in config and in Guisso.
5. Go to `http://ngrok.surveda.lvh.me/` and grab the tunnel URL: like `https://ef6e48ea.ngrok.io`.
6. Setup [Guisso](https://login-stg.instedd.org) with:
* Any hostname, no need to be `app.surveda.lvh.me`
* Redirect urls `http://app.surveda.lvh.me/session/oauth_callback`, `http://app.surveda.lvh.me/oauth_client/callback` (one per line)
* Redirect urls `https://your-id.ngrok-free.dev/session/oauth_callback`, `https://your-id.ngrok-free.dev/oauth_client/callback` (one per line)
* No need to be trusted
* Keep the identifier `MY_SURVEDA_GUISSO_CLIENT_ID` and secret `MY_SURVEDA_GUISSO_CLIENT_SECRET`.

Expand All @@ -34,7 +34,7 @@ config :alto_guisso,
client_secret: my_surveda_guisso_client_secret

config :ask, AskWeb.Endpoint,
url: [host: "app.surveda.lvh.me"]
url: [host: "your-id.ngrok-free.dev", scheme: "https", port: 443]

config :ask, Verboice,
base_url: "https://verboice-stg.instedd.org/",
Expand Down