bitrixsetup.php vs downloading the full ZIP — which is better?

bitrixsetup.php is the recommended approach: smaller upload, server fetches Bitrix directly from 1c-bitrix.ru (faster on a colocated server than your home broadband), and it auto-picks the right edition for your license. Direct ZIP makes sense only if you have a saved offline copy or no outbound HTTP from the server.

Does bitrixsetup.php require root or special permissions?

No — just web-writable permissions on the install directory (so PHP can extract files there) and outbound HTTPS to 1c-bitrix.ru. Runs under whatever user your PHP runs as (typically www-data, apache, nobody). The script itself is harmless after the install completes — but delete it once done; it's an open download endpoint.

Where do I get bitrixsetup.php from?

Official source: https://www.1c-bitrix.ru/download/bitrixsetup.php (or your account dashboard if you have a paid license). Don't grab it from a third party — it's tiny code and a compromised version could install a backdoored Bitrix. Verify size + diff against official before running.

bitrixsetup.php hangs on download — what's wrong?

Server can't reach 1c-bitrix.ru, or PHP is hitting timeouts/memory limits during extraction. Check: curl from the server (`curl -I https://www.1c-bitrix.ru/`), PHP timeouts (`max_execution_time` >= 600, `memory_limit` >= 256M), disk space, and firewall outbound rules. Some hosts block outbound HTTP from web SAPI — try CLI extraction as a fallback.

What is bitrixsetup.php?

3 min read

08.04.2025

The bitrixsetup.php file is a script provided by Bitrix (a popular CMS) to automate the installation process of the Bitrix platform. It handles downloading, unpacking, and initializing the Bitrix software directly on your server.

Bitrixsetup.php Installation Guide — bitrixsetup.php — the kickstart script for Bitrix installs.

For Bitrix configuration and tuning topics around the install, see Bitrix Virtual Appliance (BitrixVA), Setting mbstring.func_overload for Bitrix, Fix "Your PHP Version Does Not Meet the Bitrix Requirements", and Bitrix Error Log — Locate, Enable, Analyze.

Steps to Use bitrixsetup.php

Download bitrixsetup.php

Go to the official Bitrix website:
```
Bitrix Download Page
```
Download the bitrixsetup.php script.

Upload the File to Your Server

Use an FTP client (like FileZilla) or SSH to upload the file to your server root directory:
```
/var/www/html/
```
Alternatively, you can download it directly to your server using wget:
```
wget https://www.1c-bitrix.ru/download/scripts/bitrixsetup.php
```

Run the Script

Open a browser and navigate to:
```
http://yourdomain.com/bitrixsetup.php
```
Follow the on-screen instructions:
- The script will check your server environment to ensure compatibility.
- It will download and install the necessary Bitrix components.

Complete the Installation

Once the script finishes downloading the Bitrix core files, it will redirect you to the installation wizard.
Follow these steps:
- Choose installation type: Standard or custom.
- Set up the database: Provide MySQL or MariaDB credentials.
- Configure admin account: Create your administrator login.
- Finalize installation: Bitrix will install modules and complete the setup.

Common Issues and Fixes

Issue	Solution
bitrixsetup.php Fails to Load	Ensure required PHP modules are installed: `sudo apt install php-mysql php-xml php-mbstring php-gd` Set correct file permissions: `sudo chmod 644 bitrixsetup.php`
Server Compatibility Errors	Check and adjust your server configuration based on Bitrix system requirements: PHP version: 7.4+ recommended. Database: MySQL 5.7+ or MariaDB 10.3+. Memory limit: At least 128 MB. Web server: Apache or Nginx.
Slow Download Speed	Download Bitrix manually and upload the files to your server.

Post-Installation Steps

Delete the bitrixsetup.php File

For security purposes, remove the script after installation:

rm bitrixsetup.php

Enable HTTPS

Secure your Bitrix site with an SSL certificate using Let's Encrypt:

sudo certbot --apache -d yourdomain.com

Optimize Performance

Enable caching (e.g., memcached or Redis) for faster page loads.

Tips for Using Bitrix

Regular Updates

Keep your Bitrix installation up to date via the admin panel.

Backup

Set up regular backups for both files and the database.

Hosting Requirements

Consider dedicated or VPS hosting for optimal performance with Bitrix.

The bitrixsetup.php script simplifies the installation of the Bitrix CMS. By following the steps above and addressing common issues, you can quickly get your Bitrix site up and running.

What is bitrixsetup.php?

Steps to Use bitrixsetup.php

Download bitrixsetup.php

Upload the File to Your Server

Run the Script

Complete the Installation

Common Issues and Fixes

Post-Installation Steps

Delete the bitrixsetup.php File

Enable HTTPS

Optimize Performance

Tips for Using Bitrix

Regular Updates

Backup

Hosting Requirements

Hosting

Cloud Solutions

For You

VDS

Website Builders

Our services

Client Area

What is bitrixsetup.php?

Steps to Use bitrixsetup.php

Download bitrixsetup.php

Upload the File to Your Server

Run the Script

Complete the Installation

Common Issues and Fixes

Post-Installation Steps

Delete the bitrixsetup.php File

Enable HTTPS

Optimize Performance

Tips for Using Bitrix

Regular Updates

Backup

Hosting Requirements

Hosting

Cloud Solutions

For You

VDS

Website Builders

Our services

Client Area

Выберите валюту