STFossil
Small teams. Open source. Built on Fossil.

chalcedony

Unified Management for Fossil Repositories

Public | Owner: STFossil | Default branch: trunk | Last update: 2026-09-19 16:29

The "new" command:

Usage: fossil new ?OPTIONS? FILENAME
or: fossil init ?OPTIONS? FILENAME

Create a repository for a new project in the file named FILENAME. This command is distinct from "clone". The "clone" command makes a copy of an existing project. This command starts a new project.

By default, your current login name is used to create the default admin user. This can be overridden using the -A|--admin-user parameter.

By default, all settings will be initialized to their default values. This can be overridden using the --template parameter to specify a repository file from which to copy the initial settings. When a template repository is used, almost all of the settings accessible from the setup page, either directly or indirectly, will be copied. Normal users and their associated permissions will not be copied; however, the system default users "anonymous", "nobody", "reader", "developer", and their associated permissions will be copied. In case of SQL errors, rebuild the template repository and try again.

Options:

--template
FILE Copy settings from repository file
-A|--admin-user USERNAME
Select given USERNAME as admin user
--date-override DATETIME
Use DATETIME as time of the initial check-in
--sha1
Use an initial hash policy of "sha1"
--project-name
STRING The name of the project "project name in quotes"
--project-desc
STRING The description of the project "project description in quotes"

DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in year-month-day form, it may be truncated, the "T" may be replaced by a space, and it may also name a timezone offset from UTC as "-HH:MM" (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z" means UTC.

See also: clone

Clone

You can clone this repository with the following command:

fossil clone https://1wt.observer/chalcedony

Contribute

The best way to contribute is through e-mail. See the project documentation for more details.