[Self-Hosting] First iteration: improve guide and .env - 17.02.2026
Open, HighPublic
Actions

Assigned To

Authored By

	Leif_WMDE
	Jan 14 2026, 5:35 PM

Description

Context
Based on user testing with 5 engineers, the average installation time is ~120 minutes with significant friction points in documentation structure, .env configuration, and missing error checks. This epic focuses on quick wins that could installation time by +30% without requiring engineering efforts: early failure, enforced order of steps, and safe defaults.

Goal
Enable first-time technical users to complete a public Wikibase installation in ≤100 minutes on average.

Users have a clear warning about hard requirements before starting the installation
Required configuration is clearly separated from optional configuration
Placeholder values do not cause failures
The wording is clear and avoids individual concepts like 'CallBack'
Documentation follows a strict, numbered install order
Information that is not relevant for the installation is extracted

Details

Due Date: Tue, Feb 17, 12:00 AM

Related Objects
Search...

Status	Subtype	Assigned	Task
Open	Goal	None	T414606 [Self-Hosting] Improve Installation - 09.06.2026
Open		Deepesha_WMDE	T414616 [Self-Hosting] First iteration: improve guide and .env - 17.02.2026
Open		Deepesha_WMDE	T414827 [Self-Hosting] Edit installation guide
Open		Deepesha_WMDE	T414828 [Self-Hosting] Edit .env template
Open		Deepesha_WMDE	T415186 [Self-Hosting] Split content in readme on Github
Open		kera_wmde	T416239 [Self-Hosting] User test with Jacob :)

Event Timeline

Leif_WMDE created this task.Jan 14 2026, 5:35 PM

Leif_WMDE renamed this task from [Self-Hosting] Improve Installation Guide and System Setup to [Self-Hosting] Improve Installation Guide and System Setup - 17.03.2026.

Leif_WMDE triaged this task as Medium priority.

Leif_WMDE moved this task from Inbox to Goals & Epics on the Wikibase Suite Team board.

Leif_WMDE set Due Date to Mar 17 2026, 12:00 AM.

Leif_WMDE renamed this task from [Self-Hosting] Improve Installation Guide and System Setup - 17.03.2026 to [Self-Hosting] First iteration: improve installation - 17.02.2026.Fri, Jan 16, 4:28 PM

Leif_WMDE renamed this task from [Self-Hosting] First iteration: improve installation - 17.02.2026 to [Self-Hosting] First iteration: improve guide and .env - 17.02.2026.

Leif_WMDE changed Due Date from Mar 17 2026, 12:00 AM to Tue, Feb 17, 12:00 AM.

Leif_WMDE updated the task description. (Show Details)Fri, Jan 16, 4:45 PM

Leif_WMDE created subtask T414827: [Self-Hosting] Edit installation guide.Fri, Jan 16, 4:59 PM

Leif_WMDE created subtask T414828: [Self-Hosting] Edit .env template.

Leif_WMDE assigned this task to Deepesha_WMDE.Mon, Jan 19, 7:12 AM

Leif_WMDE raised the priority of this task from Medium to High.Tue, Jan 20, 3:46 PM

Leif_WMDE created subtask T415186: [Self-Hosting] Split content in readme on Github.Wed, Jan 21, 12:26 PM

Leif_WMDE moved this task from Goals & Epics to Ready for Sprint on the Wikibase Suite Team board.Wed, Jan 21, 12:30 PM

Leif_WMDE moved this task from Ready for Sprint to Sprint 10 (Jan 20 - Feb 3 on the Wikibase Suite Team board.

Leif_WMDE edited projects, added Wikibase Suite Team (Sprint 10 (Jan 20 - Feb 3); removed Wikibase Suite Team.

Leif_WMDE moved this task from Backlog to EPICS on the Wikibase Suite Team (Sprint 10 (Jan 20 - Feb 3) board.Wed, Jan 21, 12:40 PM

Leif_WMDE updated the task description. (Show Details)