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 --build

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; half-width letters, numbers, and symbols

   

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

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, TEAM is used
   • Description, icon, color, 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.

Detailed setup guide with screenshots →