UPDATE 2023/03/01 An issue has been identified in this release and we recommend holding off on upgrading until we have a fix in place.
UPDATE 2023/03/01 4:36 PM Eastern We've released a fix.
Security Onion 2.3.220 is now available! It includes Elastic 8.6.2, Grafana 9.2.10, FleetDM 4.27.1, Zeek 5.0.7, and more:
https://docs.securityonion.net/en/2.3/release-notes.html#changes
Documentation
You can find our online documentation here:
https://docs.securityonion.net/en/2.3/
You can also purchase a printed copy of our documentation from Amazon:
https://securityonion.net/book
The printed book will be updated for 2.3.220 in the next few days and includes an inspiring foreword by Richard Bejtlich that is not available anywhere else! Proceeds go to the Rural Technology Fund and the printed book also includes a 20% discount code for our on-demand training and certification.
New Installations
If you want to perform a new installation, please review the documentation and then you can find instructions here:
https://docs.securityonion.net/en/2.3/download.html
Existing 2.3 Installations
WARNING! If you have an existing Security Onion 2.3 installation that hasn't yet been updated to version 2.3.140 or higher, then you should be aware that the Elastic components will undergo a major version upgrade to version 8. Please review and follow the steps at the link below. Failure to do so could result in loss of access to all data stored inside of Elastic and a non-functioning Security Onion installation.
https://docs.securityonion.net/en/2.3/soup.html#elastic-8
Please be aware that custom settings in Kibana may be overwritten during upgrade. We recommend that you test the upgrade process on a test deployment before deploying to production. If you have a distributed deployment, then we recommend monitoring SOC Grid while your update is running to verify that all nodes update properly. If there are issues, you can review logs, services, and containers for any additional clues. If you need help, please see our support information below.
If you have custom Elasticsearch templates, please see:
https://docs.securityonion.net/en/2.3/elasticsearch.html#custom-templates
For more information about the update process, please see:
https://docs.securityonion.net/en/2.3/soup.html
AWS Marketplace
For new Security Onion 2 installations on AWS, Security Onion 2.3.220 will soon be available on AWS Marketplace via the official Security Onion 2 AMI:
https://securityonion.net/aws/?ref=_ptnr_soc_blog_230224
AMI Documentation:
https://securityonion.net/docs/cloud-ami
Existing Security Onion 2 AMI users should use the "soup" command to upgrade:
https://docs.securityonion.net/en/2.3/soup.html
Azure Marketplace
For new Security Onion 2 installations on Azure, Security Onion 2.3.220 will soon be available on the Azure Marketplace!
https://securityonion.net/azure
Azure Documentation:
https://docs.securityonion.net/en/2.3/cloud-azure.html
Existing Security Onion 2 users on Azure should use the "soup" command to upgrade:
https://docs.securityonion.net/en/2.3/soup.html
Security Onion 16.04 EOL
As a reminder, Security Onion 16.04 has reached End Of Life (EOL):
https://blog.securityonion.net/2021/04/security-onion-1604-has-reached-end-of.html
If you're still running Security Onion 16.04, please see the following for upgrade options:
https://docs.securityonion.net/en/2.3/appendix.html
Questions or Problems
If you have questions or problems, please see our community support forum guidelines:
https://docs.securityonion.net/en/2.3/community-support.html
You can then find the community support forum at:
https://securityonion.net/discuss
Thanks
Lots of love went into this release!
Special thanks to all our folks working so hard to make this release happen!
- Josh Brower
- Jason Ertel
- Wes Lambert
- Josh Patterson
- Mike Reeves
Training
Need training? Start with our free Security Onion Essentials training and then take a look at some of our other official Security Onion training!
https://securityonion.net/training
Hardware Appliances
We know Security Onion's hardware needs, and our appliances are the perfect match for the platform. Leave the hardware research, testing, and support to us, so you can focus on what's important for your organization. Not only will you have confidence that your Security Onion deployment is running on the best-suited hardware, you will also be supporting future development and maintenance of the Security Onion project!
https://securityonionsolutions.com/hardware
Screenshot Tour
If you want the quickest and easiest way to try out Security Onion 2, just follow the screenshots below to install an Import node and then optionally enable the Analyst Workstation. This can be done in a minimal VM with only 4GB RAM! For more information, please see:
https://docs.securityonion.net/en/2.3/first-time-users.html
