Please login to access all of the features of the Community Site.


    Install Rock

    Updated

    Now that your server is set up, you can install Rock. The installer downloads Rock, builds your database and starts Rock for the first time. After that, you'll turn on snapshot isolation and check that debug mode is off.

    What you'll need

    • The RockUser login and password from Configure SQL Server
    • Your organization's internal and public web addresses
    • Your organization's name, email address, phone number and website

    Run the Rock installer

    1. Go to rockrms.com/self-hosting and select Download Rock. Extract the zip file.

    2. Copy Start.aspx and web.config from the zip into the root of your web folder. By default that's C:\inetpub\wwwroot.

    Tip

    Make a fresh start - Windows puts its own files in the default wwwroot folder. Delete them before you start, so only Start.aspx and web.config are in that folder.

    3. Open a web browser on the server and go to http://localhost/Start.aspx.

    Rock Installer

    4. Enter your database details. If SQL Server is on this server, enter localhost for Database Server. Enter a name for the Rock database (for example, Rock) and the RockUser login and password. Select Next.

    Database Configuration

    5. The installer checks that your server is ready. When you see Pass!, select Next.

    Environment Checks

    6. Create Rock's admin account. This becomes the default administrator, so use a strong password and limit who has it. Select Next.

    Note

    We recommend a general or organization account, not a personal one. You can create your own login after the install.

    Admin Account Setup

    7. Enter your organization's web addresses, then select Next.

    Internal URL - The address staff use to reach Rock inside your organization (for example, http://admin.rocksolidchurchdemo.com).

    Public URL - Your organization's public website (for example, http://www.rocksolidchurchdemo.com).

    Note

    These addresses don't need to point to your new server yet. Use the ones you'll go live with.

    Hosting Configuration

    8. Enter your organization information, then select Next to start the install.

    Organization Name - Your organization's name.

    Organization Default Email Address - The address Rock sends email from by default.

    Organization Phone Number - Your main phone number.

    Organization Website - Your organization's website.

    Note

    You can change these later at Admin Tools > General Settings > Global Attributes.

    Organization Information

    9. Rock downloads its files and builds your database. Select Show Console to watch the progress.

    Installation Progress

    Installation Console

    10. When it finishes, select Flip the Switch. The first load takes the longest because Rock is starting for the first time.

    Installation Complete!

    Note

    If you land on your public website instead of the internal login page, your domain is set to the public site. Reach the internal site at http://{yourserver}/page/12.

    11. Sign in with the admin account you created.

    Login Screen

    Once you sign in, you'll see the Administrator Checklist, a list of recommended first steps. There's no rush to finish it today. It disappears once every item is checked off, and it may come back after an update if a new setting needs your attention.

    Rock Home Page

    Snapshot isolation settings

    Turn on read committed snapshot isolation for the Rock database. It keeps reads from waiting on writes, so pages stay fast while Rock saves changes.

    1. In SSMS, right-click the Rock database and select Properties.

    2. Select Options. Under Transactions and Recovery, set Is Read Committed Snapshot On to True and select OK.

    Note

    Default settings may vary - Depending on your SQL Server edition and version, this may already be on.

    Check debug mode

    Debug mode slows Rock down, so keep it off on a live server. New installs have it off, but it only takes a minute to check.

    1. Open Server Manager > Tools > Internet Information Services (IIS) Manager and select your Rock site (usually Default Web Site).

    2. Double-click .NET Compilation. Under Behavior, make sure Debug is False. If it's True, change it and select Apply.

    Note

    IIS Manager saves this change to the web.config file in your Rock folder, and Rock updates don't overwrite it. You don't need to edit the file by hand.

    Rock is installed and ready for your organization.