1 files changed, 47 insertions, 0 deletions
diff --git a/doc/server/admin/init.txt b/doc/server/admin/init.txt
new file mode 100644
index 000000000..0e8b3afd3
--- /dev/null
+++ b/doc/server/admin/init.txt
@@ -0,0 +1,47 @@
+.. -*- mode: rst -*-
+
+.. _server-admin-init:
+
+init
+====
+
+Interactively initialize a new repository.  Most values are automatically
+detected or a default value is provided. ::
+
+    bcfg2-admin init
+    Store bcfg2 configuration in [/etc/bcfg2.conf]:
+    Location of bcfg2 repository [/var/lib/bcfg2]:
+    Input password used for communication verification (without echoing; leave blank for a random):
+    What is the server's hostname [conf01.example.com]:
+    Input the server location [https://conf01.example.com:6789]:
+    Input base Operating System for clients:
+    1: Red Hat/Fedora/RHEL/RHAS/Centos
+    2: SUSE/SLES
+    3: Mandrake
+    4: Debian
+    5: Ubuntu
+    6: Gentoo
+    7: FreeBSD
+    : 1
+
+    Generating a 2048 bit RSA private key
+    .....................+++
+    .....................+++
+    writing new private key to '/etc/bcfg2.key'
+    -----
+    Signature ok
+    subject=/C=US/ST=Illinois/L=Argonne/CN=conf01.example.com
+    Getting Private key
+
+A toplevel repository structure was created under the provided path. ::
+
+    /var/lib/bcfg2
+    |-- Base
+    |-- Bundler
+    |-- Cfg
+    |-- etc
+    |-- Metadata
+    |-- Pkgmgr
+    |-- Rules
+    `-- SSHbase
+