Admin Quickstart
After the first login, this checklist walks facility admins through the essential configuration steps.
Post-Install Checklist
Change default passwords
Log in with the default admin credentials (admin@example.com / admin) and
change the password immediately. Do the same for the default researcher account
or delete it.
Set up site information
Navigate to Admin → Settings and configure:
- Site Name — your facility’s display name
- Primary/Secondary Colors — branding colors
- Contact Email — shown to researchers for support
- Logo and Favicon — optional branding assets
Create departments
Go to Admin → Departments and add your research departments. Departments organize researchers and can optionally enable department-level order sharing (configured in Settings → Extra Settings).
Configure sequencing technologies
Under Admin → Sequencing Technology, review and configure:
- Platforms — Illumina, Oxford Nanopore, PacBio, etc.
- Instruments — specific models per platform
- Library Kits — available library preparation kits
Enable or disable technologies as needed for your facility.
Customize the order form
Use Admin → Form Builder to customize the fields researchers see when creating orders. You can add, remove, or reorder fields and field groups.
A separate Study Form Builder is available for customizing study metadata forms.
Set up data storage
Under Admin → Data Compute or via the config file, set:
- Data Base Path — the directory where sequencing files are stored
- File Extensions — which file types to scan for (default:
.fastq.gz,.fq.gz,.fastq,.fq) - Scan Depth — how many directory levels to search (default: 2)
Configure pipelines (optional)
If you plan to run bioinformatics pipelines:
- Go to Admin → Pipeline Runtime
- Set the execution mode —
localorslurm - Configure Conda path and environment if using Conda
- Configure SLURM queue, cores, memory, and time limit if using SLURM
- Enable the pipeline features in Admin → Modules
Set up ENA credentials (optional)
If you plan to submit to the European Nucleotide Archive:
- Go to Admin → ENA Configuration
- Enter your Webin username and password
- Set your center name
- Start with Test Mode enabled to validate submissions against the test server
Processing Your First Order
Once a researcher submits an order:
Review the order
The order appears on your Orders page (you can see all orders as admin). Review the sample metadata and sequencing parameters.
Assign sequencing files
After sequencing, go to the Files page to browse the data directory. The system auto-detects FASTQ files and pairs R1/R2 reads. Assign files to the corresponding samples on the order.
Create a study
Go to Studies and create a new study. Assign the relevant samples from the order. The study groups samples for pipeline analysis and ENA submission.
Run a pipeline
From the study page, launch a pipeline. SeqDesk generates the samplesheet automatically from the assigned samples and files. Monitor progress in real time through the DAG visualization and weblog events.
Admin Navigation
The admin sidebar includes these sections:
| Section | Path | Purpose |
|---|---|---|
| Users | /admin/users | View all researchers, filter by department/role |
| Departments | /admin/departments | Manage research departments |
| Form Builder | /admin/form-builder | Customize order form fields |
| Study Form Builder | /admin/study-form-builder | Customize study metadata fields |
| Modules | /admin/modules | Enable/disable optional features |
| Sequencing Tech | /admin/sequencing-tech | Platforms, instruments, kits |
| Pipeline Runtime | /admin/pipeline-runtime | HPC/compute configuration |
| Data Compute | /admin/data-compute | Storage paths and file settings |
| Admin Accounts | /admin/admin-accounts | Manage admins, invite codes |
| ENA Configuration | /admin/ena | ENA credentials and test mode |
| Settings | /admin/settings | Site branding, contact info, extra settings |