GnuCash can be run from your desktop main menu by selecting the associated menu entry.
Alternatively it can be run from a shell (command line) with the command gnucash.
During the loading of the GnuCash main window you will see the
GnuCash Splash Screen where some information
about the program itself and the loading process are displayed.
The very first time you run GnuCash you will be presented with the
Cannot find default values screen that contains three
buttons:
— exits
GnuCash.
— continue
without setting default display values for GnuCash.
— will open the Update GnuCash Configuration Data assistant (see Section 3.1.2, “Update GnuCash Configuration Data assistant”) to start the setup process for a new set of default settings.
The first screen of Update GnuCash Configuration Data describes the assistant. While the data on the screen will change, the three buttons at the very bottom of the assistant will not.
— exits the assistant.
![]() | Warning |
|---|---|
If you click this button, any selections you have made up to this point will be lost. | |
— brings up the previous screen so that you can change a previous selection until the first screen.
— brings up the next screen so you can continue through the assistant.
The second screen allows you to Choose a Method
of setting gconf configuration for GnuCash.
The button will
modify .gconf path in the user’s
home directory. The button on this screen will install the
configuration files in the .gconf
directory in the user’s home directory.
After making your selection click the button to display the next screen.
If you selected Install in Home Directory the next screen presents you with three options:
GnuCash will install the data.
You will install the data yourself.
The data has already been loaded.
If you selected Update Search Path the next screen presents you with three options:
GnuCash will update search path.
You will update search path yourself.
The update search path has already been updated.
The final screen has the usual three buttons, with the difference that has changed to . Click the button to complete the initial defaults setting process. The Welcome to GnuCash screen (see Section 3.1.3, “Welcome to GnuCash dialog”) will now be opened.
After the initial defaults are completed, you will be presented with the Welcome to GnuCash! dialog with three choices:
Create a new set of accounts — Runs the New Account Hierarchy Setup assistant (see Section 3.2, “New Account Hierarchy Setup”). Select this option if you want to be assisted in creating a set of accounts.
Import my QIF files — Runs the
Import QIF Files assistant (see Section 3.3, “Import QIF Files”). Select this option
if you already have Quicken files (.qif files) from another
financial application and wish to import them into GnuCash.
Open the new user tutorial —
Opens the GnuCash Tutorial and Concepts Guide. Select this
option if you are completely new to GnuCash and
accounting concepts.
![]() | Note |
|---|---|
It is possible to run these items after you have made a choice here,
but the Welcome to GnuCash! screen will not reappear.
To try one of the other choices later, read
Section 3.2, “New Account Hierarchy Setup”, Section 3.3, “Import QIF Files” and
Section 2.2, “ | |
This screen is intended for you to use to get up and running quickly. The button is used to exit the screen. It will then prompt you with Display Welcome Dialog Again?. If you do not want to see the Welcome to GnuCash! menu again click the button. Click the button or press the keyboard Enter key for the default which is to have the Welcome to GnuCash! screen run again.
![]() | Note |
|---|---|
Selecting either of these options will leave you with a minimum
| |