Skip to content

Commit 1051549

Browse files
author
jdv
committed
removing junk for init
1 parent 71647e8 commit 1051549

File tree

1 file changed

+0
-197
lines changed
  • crowdsec-docs/unversioned/user_guides/interactive_se_install

1 file changed

+0
-197
lines changed

‎crowdsec-docs/unversioned/user_guides/interactive_se_install/01_install.mdx‎

Lines changed: 0 additions & 197 deletions
Original file line numberDiff line numberDiff line change
@@ -77,200 +77,3 @@ But if you're comfortable with Docker it also is a great way to get started and
7777

7878

7979

80-
81-
## Repository Installation
82-
83-
The CrowdSec repository contains the latest stable version of CrowdSec and is the recommended way to install our packages.
84-
85-
86-
87-
```bash
88-
curl -s https://install.crowdsec.net | sudo sh
89-
```
90-
91-
### Manual Repository Installation
92-
93-
If you prefer to manually add the repository, you can do so by following the instructions below.
94-
95-
<details>
96-
97-
<summary>Manual Repository Installation</summary>
98-
99-
<Tabs
100-
defaultValue="debian"
101-
groupId="manual-repo-install"
102-
values={[
103-
{label: 'Deb', value: 'debian'},
104-
{label: 'RPM', value: 'rpm'},
105-
]}
106-
>
107-
<TabItem value="debian">
108-
<>
109-
<p>Begin by refreshing your package cache by running</p>
110-
<CodeBlock className="language-bash">sudo apt update</CodeBlock>
111-
<p>If you are running Debian, install debian-archive-keyring so that official Debian repositories will be verified (Ubuntu users can skip this)</p>
112-
<CodeBlock className="language-bash">sudo apt install debian-archive-keyring</CodeBlock>
113-
<p>Ensure the required tools (curl, gpg, apt-transport-https) are installed before proceeding:</p>
114-
<CodeBlock className="language-bash">sudo apt install -y curl gnupg apt-transport-https</CodeBlock>
115-
<p>In order to install a deb repo, first you need to install the GPG key that used to sign repository metadata. This will change depending on whether or not your apt version is >= v.1.1. You can check this by running:</p>
116-
<CodeBlock className="language-bash">apt -v</CodeBlock>
117-
<p>For apt version >= v1.1:</p>
118-
<p>(Equivalent to or later than Debian/Raspbian Stretch, Ubuntu Xenial, Linux Mint Sarah, Elementary OS Loki)</p>
119-
> Create the directory to import the GPG key:
120-
>From apt v2.4.0, `/etc/apt/keyrings/` is the designated directory for administrator imported keys. We will be using that for the following instructions, but you can replace `/etc/apt/keyrings/` with any path of your choosing. If you need to create the directory, run:
121-
>
122-
> <CodeBlock className="language-bash">mkdir -p /etc/apt/keyrings/</CodeBlock>
123-
> Then add the GPG key:
124-
>
125-
> <CodeBlock className="language-bash">curl -fsSL https://packagecloud.io/crowdsec/crowdsec/gpgkey | gpg --dearmor > /etc/apt/keyrings/crowdsec_crowdsec-archive-keyring.gpg</CodeBlock>
126-
> Create a file named `/etc/apt/sources.list.d/crowdsec_crowdsec.list` that contains the repository configuration below.
127-
>
128-
> <CodeBlock className="language-bash">deb [signed-by=/etc/apt/keyrings/crowdsec_crowdsec-archive-keyring.gpg] https://packagecloud.io/crowdsec/crowdsec/any any main
129-
deb-src [signed-by=/etc/apt/keyrings/crowdsec_crowdsec-archive-keyring.gpg] https://packagecloud.io/crowdsec/crowdsec/any any main </CodeBlock>
130-
131-
<p>For apt version < v1.1:</p>
132-
<p>(Equivalent to or older than Debian/Raspbian Jessie, Ubuntu Wily, Linux Mint Rosa, Elementary OS Freya)</p>
133-
> Add the GPG key:
134-
>
135-
> <CodeBlock className="language-bash">curl -fsSL https://packagecloud.io/crowdsec/crowdsec/gpgkey | gpg --dearmor > /etc/apt/trusted.gpg.d/crowdsec_crowdsec.gpg</CodeBlock>
136-
> Create a file named `/etc/apt/sources.list.d/crowdsec_crowdsec.list` that contains the repository configuration below.
137-
>
138-
> <CodeBlock className="language-bash">deb https://packagecloud.io/crowdsec/crowdsec/any any main
139-
deb-src https://packagecloud.io/crowdsec/crowdsec/any any main</CodeBlock>
140-
141-
<p>Run this command update your local APT cache:</p>
142-
<CodeBlock className="language-bash">sudo apt update</CodeBlock>
143-
<p>You can now install packages from your repository.</p>
144-
</>
145-
</TabItem>
146-
<TabItem value="rpm">
147-
<>
148-
<p>Install pygpgme, a package which allows yum to handle gpg signatures, and a package called yum-utils which contains the tools you need for installing source RPMs.</p>
149-
<CodeBlock className="language-bash">sudo yum install pygpgme yum-utils</CodeBlock>
150-
<p>You may need to install the EPEL repository for your system to install these packages. If you do not install pygpgme, GPG verification will not work.</p>
151-
<p>Create a file named /etc/yum.repos.d/crowdsec_crowdsec.repo that contains the repository configuration below.</p>
152-
<p>Make sure to replace `el` and `6` in the config below with your Linux distribution and version:</p>
153-
<CodeBlock className="language-bash">
154-
[crowdsec_crowdsec]
155-
name=crowdsec_crowdsec
156-
baseurl=https://packagecloud.io/crowdsec/crowdsec/el/6/$basearch
157-
repo_gpgcheck=1
158-
gpgcheck=1
159-
enabled=1
160-
gpgkey=https://packagecloud.io/crowdsec/crowdsec/gpgkey
161-
https://packagecloud.io/crowdsec/crowdsec/gpgkey/crowdsec-crowdsec-EDE2C695EC9A5A5C.pub.gpg
162-
https://packagecloud.io/crowdsec/crowdsec/gpgkey/crowdsec-crowdsec-C822EDD6B39954A1.pub.gpg
163-
https://packagecloud.io/crowdsec/crowdsec/gpgkey/crowdsec-crowdsec-FED78314A2468CCF.pub.gpg
164-
sslverify=1
165-
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
166-
metadata_expire=3600
167-
168-
[crowdsec_crowdsec-source]
169-
name=crowdsec_crowdsec-source
170-
baseurl=https://packagecloud.io/crowdsec/crowdsec/el/6/SRPMS
171-
repo_gpgcheck=1
172-
gpgcheck=1
173-
enabled=1
174-
gpgkey=https://packagecloud.io/crowdsec/crowdsec/gpgkey
175-
https://packagecloud.io/crowdsec/crowdsec/gpgkey/crowdsec-crowdsec-EDE2C695EC9A5A5C.pub.gpg
176-
https://packagecloud.io/crowdsec/crowdsec/gpgkey/crowdsec-crowdsec-C822EDD6B39954A1.pub.gpg
177-
https://packagecloud.io/crowdsec/crowdsec/gpgkey/crowdsec-crowdsec-FED78314A2468CCF.pub.gpg
178-
sslverify=1
179-
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
180-
metadata_expire=3600
181-
</CodeBlock>
182-
<p>Update your local yum cache by running</p>
183-
<CodeBlock className="language-bash">sudo yum -q makecache -y --disablerepo='*' --enablerepo='crowdsec_crowdsec'</CodeBlock>
184-
<p>You can now install packages from your repository.</p>
185-
</>
186-
</TabItem>
187-
</Tabs>
188-
189-
</details>
190-
191-
### Install Security Engine
192-
193-
Once the repository is added, you can install the Security Engine via:
194-
195-
<Tabs
196-
defaultValue="debian"
197-
groupId="operating-systems"
198-
values={[
199-
{label: 'Debian/Ubuntu', value: 'debian'},
200-
{label: 'EL/Centos7/Amzn Linux 2', value: 'centos7'},
201-
{label: 'EL/Centos Stream 8', value: 'centos8'},
202-
{label: 'SUSE Linux', value: 'suselinux'},
203-
{label: 'OpenWRT', value: 'openwrt'},
204-
{label: 'CloudLinux', value: 'cloudlinux'},
205-
]}>
206-
<TabItem value="debian">
207-
<CodeBlock className="language-bash">apt install crowdsec</CodeBlock>
208-
</TabItem>
209-
210-
<TabItem value="centos7">
211-
<CodeBlock className="language-bash">yum install crowdsec</CodeBlock>
212-
</TabItem>
213-
214-
<TabItem value="centos8">
215-
<CodeBlock className="language-bash">dnf install crowdsec</CodeBlock>
216-
</TabItem>
217-
218-
<TabItem value="suselinux">
219-
<CodeBlock className="language-bash">zypper install crowdsec</CodeBlock>
220-
</TabItem>
221-
222-
<TabItem value="openwrt">
223-
<CodeBlock className="language-bash">opkg install crowdsec</CodeBlock>
224-
</TabItem>
225-
226-
<TabItem value="cloudlinux">
227-
<CodeBlock className="language-bash">yum install crowdsec</CodeBlock>
228-
</TabItem>
229-
</Tabs>
230-
231-
232-
### Install Remediation Component
233-
234-
:::warning
235-
Security Engine by itself is a detection engine, it will not block anything. You need to install a [Remediation Component](/bouncers/intro.md) to enforce decisions
236-
:::
237-
238-
For the quick start guide we will be installing the [iptables](https://en.wikipedia.org/wiki/Iptables) firewall [Remediation Component](/bouncers/intro.md). (This may not be optimal for your environment, please refer to the [Remediation Documentation](/bouncers/intro.md) for more information)
239-
240-
#### IPTables
241-
242-
<Tabs
243-
defaultValue="iptables_debian"
244-
values={[
245-
{ label: 'Debian/Ubuntu', value: 'iptables_debian' ,},
246-
{ label: 'RHEL/Centos/Fedora', value: 'iptables_rhel', },
247-
{ label: 'SUSE Linux', value: 'iptables_suse', },
248-
]
249-
}>
250-
<TabItem value="iptables_debian">
251-
252-
```bash
253-
sudo apt install crowdsec-firewall-bouncer-iptables
254-
```
255-
256-
</TabItem>
257-
<TabItem value="iptables_rhel">
258-
259-
```bash
260-
sudo yum install crowdsec-firewall-bouncer-iptables
261-
```
262-
263-
</TabItem>
264-
265-
<TabItem value="iptables_suse">
266-
267-
```bash
268-
sudo zypper install crowdsec-firewall-bouncer-iptables
269-
```
270-
271-
</TabItem>
272-
</Tabs>
273-
274-
## Next Steps?
275-
276-
Great, you now have CrowdSec installed on your system. Within the [post installation steps](/getting_started/next_steps.md) you will find the next steps to configure and optimize your installation.

0 commit comments

Comments
 (0)