1.1. Installation directory structure
1.1.1. General information
After installation, a directory structure will be organized on the drive, where application executable files are located. This section describes the structure of the installation directories, depending on the operating system used. Directory names can contain the abbreviation A.B.C.D, which means the full number of a 1C:Enterprise version used.
1.1.2. On Windows
The default installation directory depends on the selected installation mode. This directory will be further called the root installation directory:
- Installation "for the computer":
- 32-bit system in a 64-bit OS: %PROGRAMFILES(x86)%\1cv8.
- In other cases: %PROGRAMFILES%\1cv8
- Installation "for the user":
- 32-bit system in a 32-bit OS: %LOCALAPPDATA%\Programs\1cv8.
- 32-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x86.
- 64-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x64.
The other directories and configuration files are created in the root installation directory:
- common this directory contains the common files of 1C:Enterprise. These include the 1cestart launcher, the dongle driver installer, the Management Console snap-in to administer the 1C:Enterprise server cluster (1CV8 Servers.msc), the 1C:Enterprise files icon library for the needs of the operating system.
- conf this directory contains the configuration files necessary for the operation of 1C:Enterprise.
- srvinfo the working directory of the main server. Contains server cluster data if the 1C:Enterprise server is installed as a Windows service.
- A.B.C.D this directory contains files of a specific 1C:Enterprise version. Hereinafter this directory will be called the version directory. Installer allows you to install multiple versions of 1C:Enterprise. In this case, multiple version directories will be located in the root installation directory. So, in case of installation of versions 8.3.3.100 and 8.3.3.150 (version numbers conditional) there will be two directories with names 8.3.3.100 and 8.3.3.150. Each version directory contains all the files (except for the 1cestart file) specific to this version, namely: executable files, accompanying files, software products licenses, and so on. The version directory structure is as follows:
- bin contains the executable files of the version (directory of executable files).
- bin\conf contains the configuration files of a specific version or the conf. cfg file, which contains the path to the shared directory of configuration files (by default, the conf directory of the root installation directory). For a description of the conf.cfg file, see page .
- bin\dmf contains the files necessary for the functioning of the optimized database configuration update mechanism.
- docs this directory contains the accompanying files in the Russian and English languages. The components of files may vary from version to version.
- licenses contains the license agreement for 1C:Enterprise in Russian (1CEnterpise_ru.htm file) and English (1CEnterpise_en.htm file), as well as license agreements for third-party software components used (this list may vary from version to version).
- readme this directory contains readme files in the localization languages of the platform.
Some directories in the installation are always in a fixed place of the file system, regardless of which directory is selected during the application installation:
- The common and conf directories are always located in the following directories:
- Installation "for the computer":
- 32-bit system in a 64-bit OS: %PROGRAMFILES(x86)%\1cv8.
- In other cases: %PROGRAMFILES%\1cv8.
- Installation "for the user":
- 32-bit system in a 32-bit OS: %LOCALAPPDATA%\Programs\1cv8.
- 32-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x86.
- 64-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x64.
- Installation "for the computer":
- The installer creates the srvinfo directory only if you install the 1C:Enterprise server cluster as a Windows service. This installation is possible if 1C:Enterprise is installed in the "for the computer" mode. In this case, the srvinfo directory will be created in the following directories:
- If the bitness of 1C:Enterprise and operating system match in the%PROGRAMFILES%\1cv8 directory.
- When using the 32-bit version of the application on the 64-bit OS in the %PROGRAMFILES(x86)%\1cv8 directory.
1.1.3. On Linux
The system will be installed in the /opt/1cv8 directory (hereinafter we will call this directory as the root installation directory). The other directories and configuration files are created in the root installation directory:
- common this directory contains the common files of 1C:Enterprise. These include the dongle driver installer and the 1cescmn.cfg configuration file.
- conf this directory contains the configuration files necessary for the operation of 1C:Enterprise.
- i386. The installation directory for the 32-bit version of 1C:Enterprise. This directory contains version directories (described below).
- x86_64. The installation directory for the 64-bit version of 1C:Enterprise. This directory contains version directories (described below).
- The directory of a specific architecture contains a directory of the A.B.C.D. type. This directory contains files of a specific 1C:Enterprise version. Hereinafter this directory will be called the version directory. The full path to the directory of the 32-bit version will look as follows: /opt/1cv8/i386/A.B.C.D. It will look as follows for the 64-bit version: /opt/1cv8/x86_64/A.B.C.D.
Installer allows you to install multiple versions of 1C:Enterprise. In this case, several version directories will be located in the directory of the appropriate architecture. So, in case of installation of versions 8.3.18.100 and 8.3.18.150 (version numbers are conditional) there will be two version directories with names 8.3.18.100 and 8.3.18.150. Each version directory contains all the files (except for the 1cestart file) specific to this version, namely: executable files, accompanying files, software products licenses, and so on. The version directory structure is as follows:
- conf this directory contains the configuration files necessary for the operation of 1C:Enterprise.
- docs this directory contains the accompanying files in the Russian and English languages. The components of files may vary from version to version.
- licenses contains the license agreement for 1C:Enterprise in Russian (1CEnterpise_ru.htm file) and English (1CEnterpise_en.htm file), as well as license agreements for third-party software components used (this list may vary from version to version).
- readme this directory contains readme files in the localization languages of the platform.
- ExtDst contains additional utilities designed for use in conjunction with the 1C:Enterprise application.
Note that you can manually place previous 1C:Enterprise versions (up to the version 8.3.18) in the directory structure described above. To do this, correctly specify the directories of specific versions. After the placement, launchers start using previous 1C:Enterprise versions to automatically select the client applications to be started.
1.1.4. On macOS
The system will be installed in the /opt/1cv8 directory (hereinafter we will call this directory as the root installation directory). The other directories and configuration files are created in the root installation directory:
- common this directory contains the common files of 1C:Enterprise. These include the dongle driver installer and the 1cescmn.cfg configuration file.
- conf this directory contains the configuration files necessary for the operation of 1C:Enterprise.
- A.B.C.D this directory contains files of a specific 1C:Enterprise version. Hereinafter this directory will be called the version directory. Installer allows you to install multiple versions of 1C:Enterprise. In this case, multiple version directories will be located in the root installation directory. So, in case of installation of versions 8.3.3.100 and 8.3.3.150 (version numbers conditional) there will be two directories with names 8.3.3.100 and 8.3.3.150. Each version directory contains all the files (except for the 1cestart file) specific to this version, namely: executable files, accompanying files, software products licenses, and so on. The version directory structure is as follows:
- conf this directory contains the configuration files necessary for the operation of 1C:Enterprise.
- docs this directory contains the accompanying files in the Russian and English languages. The components of files may vary from version to version.
- licenses contains the license agreement for 1C:Enterprise in Russian (1CEnterpise_ru.htm file) and English (1CEnterpise_en.htm file), as well as license agreements for third-party software components used (this list may vary from version to version).
- readme this directory contains readme files in the localization languages of the platform.
1.2. Assigning files
1.2.1. General information
This section describes some files that are part of 1C:Enterprise. When describing directories, A.B.C.D means the full version number of 1C:Enterprise.
1.2.2. 1cestart
1C:Enterprise application launcher. Using the launcher, you can start all types of clients (thick client, thin client, Web client), Designer.
TIP. If the launcher is located in a network directory (see page ), it is recommended that you use this program from the latest version, which you plan to install from that network directory.
- On Windows OS:
- Installation "for the computer":
- 32-bit system in a 64-bit OS: %PROGRAMFILES(x86)%\1cv8\common.
- In other cases: %PROGRAMFILES%\1cv8\common.
- Installation "for the user":
- 32-bit system in a 32-bit OS: %LOCALAPPDATA%\Programs\1cv8\common.
- 32-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x86\common.
- 64-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x64\common.
- Installation "for the computer":
- On Linux:
- If the bitness of the OS and the application you install match: /opt/1cv8/common.
- If the bitness of the OS and the application you install do not match: not installed.
- On macOS:
- 64-bit OS: /opt/1cv8/A.B.C.D.
1.2.3. 1cv8s
Interactive launcher of the specific version of 1C:Enterprise application. The launcher can start all types of clients (thick client, thin client, web client), Designer.
- On Windows OS:
- Installation "for the computer":
- 32-bit system in a 64-bit OS: %PROGRAMFILES(x86)%\1cv8\A.B.C.D\bin.
- In other cases: %PROGRAMFILES%\1cv8\A.B.C.D\bin.
- Installation "for the user":
- 32-bit system in a 32-bit OS: %LOCALAPPDATA%\Programs\1cv8\A.B.C.D\bin.
- 32-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x86\A.B.C.D\bin.
- 64-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x64\A.B.C.D\bin.
- Installation "for the computer":
- On Linux:
- 32-bit OS: /opt/1cv8/i386/A.B.C.D.
- 64-bit OS: /opt/1cv8/x86_64/A.B.C.D.
- On macOS:
- 64-bit OS: /opt/1cv8/A.B.C.D.
1.2.4. 1cv8
Executable file of thick client or Designer.
Cannot start thin client or web client.
File location:
- On Windows OS:
- Installation "for the computer":
- 32-bit system in a 64-bit OS: %PROGRAMFILES(x86)%\1cv8\A.B.C.D\bin.
- In other cases: %PROGRAMFILES%\1cv8\A.B.C.D\bin.
- Installation "for the user":
- 32-bit system in a 32-bit OS: %LOCALAPPDATA%\Programs\1cv8\A.B.C.D\bin.
- 32-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x86\A.B.C.D\bin.
- 64-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x64\A.B.C.D\bin.
- Installation "for the computer":
- On Linux:
- 32-bit OS: /opt/1cv8/i386/A.B.C.D.
- 64-bit OS: /opt/1cv8/x86_64/A.B.C.D.
- On macOS:
- 64-bit OS: /opt/1cv8/A.B.C.D.
1.2.5. 1cv8c
Executable file of thin client.
File location:
- On Windows OS:
- Installation "for the computer":
- 32-bit system in a 64-bit OS: %PROGRAMFILES(x86)%\1cv8\A.B.C.D\bin.
- In other cases: %PROGRAMFILES%\1cv8\A.B.C.D\bin.
- Installation "for the user":
- 32-bit system in a 32-bit OS: %LOCALAPPDATA%\Programs\1cv8\A.B.C.D\bin.
- 32-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x86\A.B.C.D\bin.
- 64-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x64\A.B.C.D\bin.
- Installation "for the computer":
- On Linux:
- 32-bit OS: /opt/1cv8/i386/A.B.C.D.
- 64-bit OS: /opt/1cv8/x86_64/A.B.C.D.
- On macOS:
- 64-bit OS: /opt/1cv8/A.B.C.D.
1.2.6. 1cv8a
Administrative console utility. For utility description, see page .
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: in the directory with executable files of a specific version.
- On macOS: in the directory with executable files of a specific version.
1.2.7. ragent, rmngr, rphost
Executable files of 1C:Enterprise server 1C:Enterprise server structure {HL:cs:TI000000020: described in the book}.
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: in the directory with executable files of a specific version.
- On macOS: none.
1.2.8. crserver
Configuration repository server. Configuration repository operation {HL:dev:TI000001091:described in the book}.
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: in the directory with executable files of a specific version.
- On macOS: none.
1.2.9. dbgs
1C:Enterprise debug server Application debugging {HL:dev:TI000001031: described in the book}.
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: in the directory with executable files of a specific version.
- On macOS: in the directory with executable files of a specific version.
1.2.10. dbda
Data accelerator. Works only as part of the 1-bit: 1C:Enterprise server cluster. Designed to speed up the execution of complex analytical reports. In more detail {HL:dev:: is described in the book}.
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: in the directory with executable files of a specific version.
- On macOS: none.
1.2.11. webinst
Web Client Publishing Configuration Utility on Web server (for more information, see page ).
- On Windows: in the directory with executable files of a specific version.
- On Linux: in the directory with executable files of a specific version.
- On macOS: none.
1.2.12. chdbfl
The file mode database testing utility (for details see page ).
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: in the directory with executable files of a specific version.
- On macOS: none.
1.2.13. cnvdbfl
File mode database conversion utility (for details see page ).
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: in the directory with executable files of a specific version.
- On macOS: in the directory with executable files of a specific version.
1.2.14. ci
Integrity monitoring utility. For a detailed description of the utility, see page .
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: in the directory with executable files of a specific version.
- On macOS: in the directory with executable files of a specific version.
1.2.15. dumper
Utility to generate crash dumps. This utility is used when specifying the externaldump="true" attribute in the logcfg.xml file (for details see page ).
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: none.
- On macOS: none.
1.2.16. v7cnv.exe
Converter of infobases from 1C:Enterprise 7.7 to the current version. Converter {HE:dev:TI000001215:described in the book}.
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: none.
- On macOS: none.
1.2.17. RegMSC.cmd
Command file for registration of the administration utility for 1C:Enterprise server cluster of a specific version (located in the directory of executable files of a specific version).
File location:
- On Windows: in the directory with executable files of a specific version.
- On Linux: none.
- On macOS: none.
1.2.18. 1ceunt.dll
Library of icons used by OS to display 1C:Enterprise file types. This library is common to all versions of the application. Registration of this library (and associating icons with file types) is performed on the first installation of 1C:Enterprise on the computer. Canceling the library registration (and removing icons association with file types) is performed when the latest version of 1C:Enterprise is removed from the computer.
File location:
- On Windows: in the common directory of the root installation directory.
- On Linux: none.
- On macOS: none.
1.3. Configuration files: location and search
1.3.1. General information
Configuration files used for 1C:Enterprise (logcfg.xml, nethasp.ini, and so on) can be stored at different locations in the file system. The order of searching for these configuration files in different directories is defined. This search order of configuration files allows the system to:
- Generate unified configuration files for all versions and components installed on the computer. To do this, the configuration files must be located only in the conf directory of the root installation directory.
- Generate configuration files separately for each version installed on the computer. To do this, the configuration files should be located only in the bin\conf directory.
- Generate different configuration files for different components (for the 1C:Enterprise client application and server, operating under another user of the system) of any version running on the computer. To do this, the configuration files must be located in the directories of configuration files available for all computer users (the list of such directories depends on an operating system used and 1C:Enterprise installation mode).
- Use combinations of these methods for different configuration files.
When describing directories, A.B.C.D means the full version number of 1C:Enterprise.
1.3.2. On Windows
In Windows, files can be stored in the following locations (in the search order):
- The bin\conf directory of a specific 1C:Enterprise version:
- Installation "for the computer":
- 32-bit system in a 64-bit OS: %PROGRAMFILES(x86)%\1cv8\A.B.C.D\bin\conf.
- In other cases: %PROGRAMFILES%\1cv8\A.B.C.D\bin\conf.
- Installation "for the user":
- 32-bit system in a 32-bit OS: %LOCALAPPDATA%\Programs\1cv8\A.B.C.D\bin\conf.
- 32-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x86\A.B.C.D\bin\conf.
- 64-bit system in a 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x64\A.B.C.D\bin\conf.
- Installation "for the computer":
- %USERPROFILE%\Local Settings\Application Data\1C\1cv8\conf (%LOCALAPPDATA%\1C\1cv8\conf for Windows Vista and later) directory of the user on whose behalf the application runs.
- The directory specified in the Conf.cfg file that is located in the bin\conf directory of the specific version. For details on conf.cfg file format, see page .
- %ALLUSERSPROFILE%\Application Data\1C\1cv8\conf (%ALLUSERSPROFILE%\1C\1cv8\conf for Windows Vista and later) data directory for all users of the computer.
NOTE. When the application is being installed, the configuration files are written to the conf directory of the root installation directory, and this path is written to the bin\conf\conf.cfg file of the version to be installed.
1.3.3. On Linux
On Linux, files can be located in the following places (in the search order):
- The conf directory of a specific version, for example, /opt/1cv8/arch/A.B.C.D/conf, where:
- arch. The processor architecture used:
- i386. 32-bit architecture.
- x86_64. 64-bit architecture.
- arch. The processor architecture used:
- The conf directory of the root installation directory: /opt/1cv8/conf.
- Directory ~/.1cv8/1C/1cv8/conf (~ home directory of the user, on behalf of which the 1C:Enterprise client application operates).
- The directory specified in the conf.cfg file that is located in the conf directory of the specific version. For details on conf.cfg file format, see page .
1.3.4. On macOS
On macOS, files can be located in the following places (in the search order):
- The conf directory of the version installed, for example, /opt/1cv8/A.B.C.D/conf.
- The conf directory of the root installation directory: /opt/1cv8/conf.
- Directory ~/.1cv8/1C/1cv8/conf (~ home directory of the user, on behalf of which the 1C:Enterprise client application operates).
- The directory specified in the conf.cfg file that is located in the conf directory of the specific version. For details on conf.cfg file format, see page .