Skip to content

Setup documentation needs improving #477

@Daenara

Description

@Daenara

I am currently looking for a translation management tool for our use at work and this one looks somewhat promising, but I have a few issues, mostly to do with the documentation. For now all I want is to run it locally to take a look at the UI and evaluate if it is what we are looking for (the web demo is down).

Here are my issues:

  1. The website and the github documentation differ quite a bit. There is no mention of the docker images on the website documentation, I would prefer to use the docker-compose file since it includes the database but getting that running is a bit problematic
  2. The docker-compose.yaml is not working out of the box.
    I did disable the password error with POSTGRES_HOST_AUTH_METHOD=trust (not the best way but it got me past) only to get a website with no login field.
    So I added DUMMY_LOGIN_ENABLED=1 which made the email field show up and then had to hunt through the code for the actual dummy login information. I am still not sure if I found them (currently trying with 'email').
    Clicking login triggers a 500 error and the log shows that the base secret key is too short and needs to be minimum 6 characters. So I put SECRET_KEY_BASE=THISISSECRET but I still keep getting the error...
  3. Just a side note, docker compose complains about there being a version still included in the docker-compose.yaml file which should be removed. This his no impact on anything working

I am giving up on this for now. This is a suboptimal first expression and I just can't justify spending even more time on this just to get a look at it to evaluate if we can use it. Hopefully this will be taken care of eventually so it will not turn more ppl away.

accent           | 09:19:57.834 request_id=GE4WGBgrfdMAIzIAAAAQ [info] GET /
accent           | 09:19:57.835 request_id=GE4WGBgrfdMAIzIAAAAQ [info] Sent 200 in 1ms
accent           | 09:19:58.047 request_id=GE4WGCTi4rDcIlAAAANJ [info] GET /.well-known/appspecific/com.chrome.devtools.json
accent           | 09:19:58.048 request_id=GE4WGCTi4rDcIlAAAANJ [info] Sent 404 in 205µs
accent           | 09:19:58.441 request_id=GE4WGDxcqWM6TQYAAAOJ [info] POST /graphql
accent           | 09:19:58.446 request_id=GE4WGDxcqWM6TQYAAAOJ graphql_operation=AuthenticationProviders [info] Sent 200 in 4ms
accent           | 09:20:01.352 request_id=GE4WGOnd4DMAIzIAAARJ [info] GET /auth/dummy/callback
accent           | 09:20:01.367 request_id=GE4WGOnd4DMAIzIAAARJ [info] Sent 500 in 15ms
accent           | 09:20:01.369 request_id=GE4WGOnd4DMAIzIAAARJ [error] ** (ArgumentError) cookie store expects conn.secret_key_base to be at least 64 bytes
accent           |     (plug 1.18.0) lib/plug/session/cookie.ex:184: Plug.Session.COOKIE.validate_secret_key_base/1
accent           |     (plug 1.18.0) lib/plug/session/cookie.ex:176: Plug.Session.COOKIE.derive/3
accent           |     (plug 1.18.0) lib/plug/session/cookie.ex:95: Plug.Session.COOKIE.put/4
accent           |     (plug 1.18.0) lib/plug/session.ex:96: anonymous fn/3 in Plug.Session.before_send/2
accent           |     (elixir 1.18.3) lib/enum.ex:2546: Enum."-reduce/3-lists^foldl/2-0-"/3
accent           |     (plug 1.18.0) lib/plug/conn.ex:1908: Plug.Conn.run_before_send/2
accent           |     (plug 1.18.0) lib/plug/conn.ex:445: Plug.Conn.send_resp/1
accent           |     (accent 1.25.3) lib/web/controllers/auth_controller.ex:1: Accent.AuthController.action/2
accent           | 
accent           | 09:20:01.438 request_id=GE4WGO8DlaQ6TQYAAAWJ [info] GET /.well-known/appspecific/com.chrome.devtools.json
accent           | 09:20:01.439 request_id=GE4WGO8DlaQ6TQYAAAWJ [info] Sent 404 in 147µs

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions