Project Management That Works for Developers

Detailed setup guide with screenshots →

1. 1

   Clone, configure, and start

   Clone the repository, copy .env.example to .env, and fill in DB_PASSWORD and JWT_SECRET_KEY — the sed line below generates random values for you (macOS / Linux / WSL). Then start with Docker Compose. It stops right away with a clear message if either value is empty.

   git clone https://github.com/macplanning-labs/senn.git
   cd senn
   cp .env.example .env
   sed -i.bak "s|^DB_PASSWORD=.*|DB_PASSWORD=$(openssl rand -hex 24)|; s|^JWT_SECRET_KEY=.*|JWT_SECRET_KEY=$(openssl rand -base64 48 | tr -d '\n')|" .env && rm .env.bak
   docker compose up

   The first run takes a few minutes to download the pre-built images (depending on your connection). Keep this terminal open — closing it stops SENN. To build the images from source instead, use docker compose up --build (10–15 minutes the first time).

2. 2

   Open the app

   Once the containers are up, open this URL in your browser:

   http://localhost:8151

3. 3

   Sign up and log in

   When the login screen appears, if you do not have an account yet, do not log in — click Sign up at the bottom.

   

   On the registration screen, fill in these fields, then click Sign up:

   • Username — at least 1 character; any letters including Japanese; must be unique
   • Email — a valid address (e.g. you@example.com)
   • Password — at least 8 characters

   

   When registration succeeds, you are signed in automatically and land on My tickets — no separate login needed.

   Only the first person (who set up the server) can sign up freely. Everyone after that joins by invitation — see step 6.

4. 4

   Create a Team

   You need a team before creating tickets. The post-login My tickets screen shows a “Get started with SENN” panel — you can create the team right from there.

   Click the + next to Teams in the left sidebar (or click Create your first team — same result).

   The Create team dialog opens.

   Fill in the fields below and click Create.

   • Team name — required; any name is fine
   • Team prefix — optional. The start of ticket keys (e.g. SMP → SMP-000001). If blank, it is made from the letters and digits in the team name (TEAM if the name has none)
   • Icon, color, visibility (Public / Private), description, and notification webhook are optional (editable later)

   After creation, the team appears under “Teams” in the sidebar.

5. 5

   Create your first ticket

   On the screen right after creating the team, click Create a ticket.

   The Team field already has your new team selected.

   Type a Title and click Create Ticket.

   • Title — required
   • Description — optional
   • Assignee, priority, due date, and other fields are optional (editable later)

   Open Tickets in the sidebar to see the new ticket in the list. That completes the first end-to-end flow.

6. 6

   Invite teammates

   From the second person on, accounts are created by invitation. Open the team's Settings → Members, enter the person's email under Invite, choose Full Member (the default is Guest, which only lets them view this team), and click Send invitation.

   • If email is not configured (the default), SENN shows a link instead of sending mail. Send that link to the person yourself — it works once and expires after 7 days.
   • The person opens the link, chooses a username and password, and joins the team.
   • To let people sign up on their own, set SENN_INTERNAL_EMAIL_DOMAINS (requires email settings) or SENN_REGISTRATION_MODE=open (private networks only) in .env. See the README.

Detailed setup guide with screenshots →